home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / prog / gipv30a1.zip / INSTALL.DOC < prev    next >
Text File  |  1992-03-20  |  8KB  |  176 lines
  1.                           Generic Install Program               Mar. 20, 1992
  2.  
  3.                                   ver 3.00a
  4.  
  5.                                      by
  6.  
  7.                            Kenneth E. Sandquist Jr.
  8.  
  9.                           --------------------------
  10.  
  11.      Generic Install Program (GIP) is a "programmers' tool" to allow you to
  12. install your software packages with a professional look!  After all, isn't
  13. the installation of your package the first thing people see?
  14.  
  15.      GIP has several nice features that can alleviate the hassle and extra
  16. code in your programs.  It allows for minimum memory amount checking, 
  17. available disk drive space, 32-bit CRC checking, and existing file and 
  18. directory checks!  All this is done in a nice, professional 3-D type screen.
  19.  
  20.      To use GIP, a file is required (INSTALL.LST) to tell GIP what files to
  21. install, where to install them, and file CRC's and sizes.
  22.  
  23.      To create the INSTALL.LST file, a program is included in this package
  24. appropriately named: CREATE.EXE. If you are using this version for the first
  25. time, just type 
  26.  
  27.         C:\GINSTALL> CREATE <RETURN>
  28.       
  29. CREATE will proceed to ask you several questions:
  30.  
  31.       1) Enter INSTALL directory name:
  32.          The name you type in here should be the directory you would prefer
  33.          your package to be installed to.
  34.  
  35.       2) Enter the executable name:
  36.          You should type the name of the main executable (the program that 
  37.          starts your software) of your package.  The default is NONE.
  38.  
  39.       3) Copy files to what floppy/hard drive?
  40.          Enter the disk drive you wish to transfer your package to.
  41.          A list of valid drives is provided.
  42.  
  43.       4) Enter minimum memory required:
  44.          This value should be the least amount of memory required for your
  45.          program to run.  The default is 384 kbytes.
  46.  
  47.          You are then given the opportunity to verify your answers and to 
  48.          make any changes.
  49.       
  50.       5) Which disk size is your program going to be installed from?
  51.          You are given 5 choices here:
  52.            a) 360k
  53.            b) 1.2M
  54.            c) 720k
  55.            d) 1.44M
  56.            e) UNLIMITED
  57.          Choose the format you are copying your files to (see question #3).
  58.          If you have less than this amount available on the disk, CREATE will
  59.          adjust the maximum space available accordingly.
  60.  
  61.  
  62.  
  63.  
  64. CREATE will now proceed to provide you with a file menu system to tag and
  65. copy files to the destination and create the INSTALL.LST file.  If you ever
  66. need help, just press F1.  A help window will pop up telling you what keys do
  67. what.  Pressing ESC any time during CREATE will abort!
  68.  
  69.      Use the space bar to tag files individually or use the ALT-T to "batch" 
  70. tag files, ALT-U to "batch" un-tag files, or ALT-R to reverse all tags - 
  71. files that were tagged are now cleared and files that were clear are now 
  72. tagged!  CREATE will keep track of the tagged byte count and warn you when 
  73. you have exceeded the amount of space available on the drive you are copying 
  74. files to!
  75.  
  76. **NOTE:
  77.      
  78.      The "Bytes tagged" and the "Adj. file size" are the amount of bytes 
  79.      that the file(s) will take up once transferred to disk and not the 
  80.      ACTUAL bytes!
  81.      
  82.      You can change directories and/or drives by tabbing over to the 
  83. directory window, selecting the drive/directory to change to and hitting 
  84. RETURN!  CREATE will read all of the files in that directory and display them
  85. for tagging! (By the way, CREATE will keep track of the files tagged for the
  86. disk number you are working on!)
  87.  
  88.      Once you have tagged all the files you want on the first disk, press    
  89. ALT-S to copy the files to the drive you specified.  You do this until you
  90. have copied all files to all disks.  To complete the CREATE process, hit F10
  91. and CREATE will make the INSTALL.LST file on disk 1 (CREATE will prompt you
  92. to insert disk 1 in the specified drive!)!  
  93.  
  94.      When you hit F10, a message may come up and tell you that you have not
  95. yet copied the program INSTALL.EXE over to the specified drive.  This is 
  96. quite normal if you do not want to include this program with your install 
  97. set.  (If you use CREATE to copy INSTALL.EXE to the drive you specified, it 
  98. will be included in the install.  Otherwise, copy it over manually and it will
  99. not be included!)
  100.  
  101. That's it!
  102.  
  103.      The CREATE process is now complete!  After you have become familiar with 
  104. the CREATE process, you can type:
  105.  
  106.         C:\GINSTALL> CREATE /NOH <RETURN>
  107.  
  108. The /NOH stands for "no help"...When CREATE displays the file system, it no
  109. longer displays the help screen first.  F1 will still display the help 
  110. window during the process!
  111.  
  112.      Once you have distributed your software with the INSTALL...
  113.  
  114.      Have the user type INSTALL at the DOS prompt and INSTALL will take over
  115. with little or no help from the user.  INSTALL will ask the user to enter the
  116. drive to install onto (default = C:).  Then it will ask them to enter the
  117. directory name where they would like to install your package (your preferred
  118. directory name is shown as the default...they can either hit ENTER or type in
  119. their own directory!).  If the specified directory already exists on the
  120.  
  121.  
  122.  
  123. drive, the installer is warned that it exists and is prompted to either quit
  124. or continue to use that directory.  The next, and in most cases the last,
  125. step is to hit any key to start the install.  That's it!  If INSTALL comes
  126. across a filename that already exists in the path specified, the user is
  127. prompted to overwrite the file.  They can enter 1 of 3 answers:
  128.  
  129.       1) Y - yes, I want to overwrite this file!
  130.       2) N - no, skip this file and go on!
  131.       3) A - yes, I want to overwrite this file and all others that may exist!
  132.  
  133. At any time during the install, the user can hit the ESC key to stop the
  134. program and prompt them to abort.
  135.  
  136. ERRORS:
  137.                                            
  138.      There is only one message that, under normal circumstances, should appear
  139. in the MESSAGES window and that is XXXXXXXX.XXX Bad CRC!  This is not a
  140. serious error; However, it is advisable to have the installer inform you of
  141. this error and what file it occurred on.  What this error means is that the
  142. file in error no longer matches the CRC value in the INSTALL.LST file.  There
  143. could be several reasons for this: bad disk, old CRC value in the list, or the
  144. file has been altered.  It's up to you, the programmer, to decide what the
  145. user should do when this error occurs...INSTALL will still install the file
  146. with just a warning to the user!
  147.  
  148. -----------------------------------------------------------------------------
  149.                            
  150.                            Who is Vision Software?
  151.  
  152.      Vision Software was created by the author Kenneth E. Sandquist Jr.
  153.  
  154.                             3187A Aqueduct Drive
  155.                             Lexington, KY 40517
  156.  
  157.     The author can be reached at three major boards in the US:
  158.  
  159.         Vern Beurg's Motherboard.......1-707-778-8944
  160.                                     or 1-707-778-8841
  161.         
  162.         Ken Prevo's dBasic's Toolkit...1-219-696-3415
  163.                                     
  164.         Don Bodley's Professional BBS..1-606-269-1565
  165. -----------------------------------------------------------------------------
  166.  
  167.                                  Disclaimer
  168.  
  169.           INSTALL is distributed as-is.  The author disclaims all
  170.           warranties, expressed or implied.  The author will assume
  171.           no liability for damages either from the direct use of this
  172.           product or as a consequence of the use of this product.
  173.  
  174. -----------------------------------------------------------------------------
  175.  
  176.